package com.ruoyi.shop.service;

import java.util.List;

import com.ruoyi.common.core.domain.AjaxResult;
import com.ruoyi.common.enums.ShopSourceTypeEnums;
import com.ruoyi.shop.domain.ShopPointsIncome;

/**
 * 积分获取记录Service接口
 * 
 * @author liuwp
 * @date 2025-11-24
 */
public interface IShopPointsIncomeService 
{
    /**
     * 查询积分获取记录
     * 
     * @param id 积分获取记录主键
     * @return 积分获取记录
     */
    public ShopPointsIncome selectShopPointsIncomeById(Long id);

    /**
     * 查询积分获取记录列表
     * 
     * @param shopPointsIncome 积分获取记录
     * @return 积分获取记录集合
     */
    public List<ShopPointsIncome> selectShopPointsIncomeList(ShopPointsIncome shopPointsIncome);

    /**
     * 根据业务主键查询一条记录：积分获取记录
     *
     * @param shopPointsIncome 积分获取记录
     * @return 积分获取记录
     */
    public ShopPointsIncome selectOneShopPointsIncome(ShopPointsIncome shopPointsIncome);

    /**
     * 新增积分获取记录
     * 
     * @param shopPointsIncome 积分获取记录
     * @return 结果
     */
    public int insertShopPointsIncome(ShopPointsIncome shopPointsIncome);

    /**
     * 修改积分获取记录
     * 
     * @param shopPointsIncome 积分获取记录
     * @return 结果
     */
    public int updateShopPointsIncome(ShopPointsIncome shopPointsIncome);

    /**
     * 修改积分获取记录
     *
     * @param shopPointsIncome 积分获取记录
     * @param shopPointsIncome 积分获取记录条件
     * @return 结果
     */
    public int updateShopPointsIncomeCondition(ShopPointsIncome shopPointsIncome, ShopPointsIncome shopPointsIncomeCondition);

    /**
     * 批量删除积分获取记录
     * 
     * @param ids 需要删除的积分获取记录主键集合
     * @return 结果
     */
    public int deleteShopPointsIncomeByIds(Long[] ids);

    /**
     * 删除积分获取记录信息
     * 
     * @param id 积分获取记录主键
     * @return 结果
     */
    public int deleteShopPointsIncomeById(Long id);

    /**
     * 条件删除积分获取记录
     *
     * @param shopPointsIncome 积分获取记录
     * @return 结果
     */
    public int deleteShopPointsIncomeByCondition(ShopPointsIncome shopPointsIncome);

    /**
     * 积分操作记录
     * @param userId
     * @param points
     * @param shopSourceTypeEnums
     * @param remark
     * @param assetsId
     * @return
     */
    public AjaxResult pointsOperationRecord(Long userId, Long points, ShopSourceTypeEnums shopSourceTypeEnums, String remark, String assetsId);
}
